chroma-js is a JavaScript library for color conversions and color scales. It provides a wide range of functionalities for color manipulation, including color creation, color scales, color interpolation, and color analysis.
Color Creation
You can create colors using various input formats such as named colors, hex codes, RGB, HSL, etc. The example demonstrates creating a color from a named color and converting it to a hex code.
const chroma = require('chroma-js');
const color = chroma('red');
console.log(color.hex()); // #FF0000Color Scales
Chroma-js allows you to create color scales that can interpolate between multiple colors. The example shows creating a grayscale scale and getting the color at the midpoint.
const chroma = require('chroma-js');
const scale = chroma.scale(['white', 'black']);
console.log(scale(0.5).hex()); // #808080Color Interpolation
You can interpolate between two colors using chroma-js. The example demonstrates mixing red and blue to get a purple color.
const chroma = require('chroma-js');
const color1 = chroma('red');
const color2 = chroma('blue');
const interpolatedColor = chroma.mix(color1, color2, 0.5);
console.log(interpolatedColor.hex()); // #800080Color Analysis
Chroma-js provides methods to analyze colors, such as getting the luminance. The example shows how to get the luminance of the color orange.
const chroma = require('chroma-js');
const color = chroma('orange');
console.log(color.luminance()); // 0.5The 'color' package is a JavaScript library for color conversion and manipulation. It supports a wide range of color models and provides methods for color transformations. Compared to chroma-js, it is more focused on color conversions and less on color scales and interpolation.
TinyColor is a small color manipulation and conversion library. It provides similar functionalities to chroma-js, such as color creation, manipulation, and conversion. However, it is designed to be lightweight and may not have as extensive features for color scales and interpolation as chroma-js.
d3-color is part of the D3.js library and provides color manipulation and conversion functionalities. It integrates well with other D3 modules for data visualization. While it offers similar color manipulation features, it is more commonly used within the context of D3 visualizations.
Chroma.js is a tiny small-ish zero-dependency JavaScript library (13.4kB) for all kinds of color conversions and color scales.
Install from npm
npm install chroma-js
Import package into project
import chroma from "chroma-js";
Initiate and manipulate colors:
chroma('#D4F880').darken().hex(); // #a1c550
Working with color scales is easy, too:
scale = chroma.scale(['white', 'red']);
scale(0.5).hex(); // #FF7F7F
Lab/Lch interpolation looks better than RGB
chroma.scale(['white', 'red']).mode('lab');
Custom domains! Quantiles! Color Brewer!!
chroma.scale('RdYlBu').domain(myValues, 7, 'quantiles');
And why not use logarithmic color scales once in your life?
chroma.scale(['lightyellow', 'navy']).domain([1, 100000], 7, 'log');
Why not dive into the interactive documentation (there's a static version, too). You can download chroma.min.js or use the hosted version on cdnjs.com.
You can use it in node.js, too!
npm install chroma-js
Or you can use it in SASS using chromatic-sass!
First clone the repository and install the dev dependencies:
git clone git@github.com:gka/chroma.js.git
cd chroma.js
npm install
Then compile the coffee-script source files to the build files:
npm run build
Don't forget to tests your changes! You will probably also want to add new test to the /test folder in case you added a feature.
npm test
And to update the documentation just run
npm run docs
To preview the docs locally you can use
npm run docs-preview
Chroma.js is written by Gregor Aisch.
Released under BSD license. Versions prior to 0.4 were released under GPL.
There have been no commits in X weeks. Is chroma.js dead?
No! It's just that the author of this library has other things to do than devoting every week of his life to making cosmetic changes to a piece of software that is working just fine as it is, just so that people like you don't feel like it's abandoned and left alone in this world to die. Bugs will be fixed. Some new things will come at some point. Patience.
I want to help maintaining chroma.js!
Yay, that's awesome! Please say hi at our Discord chat to get in touch
FAQs
JavaScript library for color conversions
We found that chroma-js demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Socket's threat research team has detected five malicious npm packages targeting Roblox developers, deploying malware to steal credentials and personal data.
Security News
vlt introduced its new package manager and a serverless registry this week, innovating in a space where npm has stagnated.
Security News
Research
The Socket Research Team uncovered a malicious Python package typosquatting the popular 'fabric' SSH library, silently exfiltrating AWS credentials from unsuspecting developers.